DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers externes
  • Gestion des erreurs
  • Retour chariot à la fin d'une ligne
  • Position dans le fichier
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Écrit un bloc d'octets dans un fichier externe.
Attention : Les éléments ajoutés ne sont pas insérés dans le fichier externe mais écrasent les éléments existants.
Exemple
Syntaxe

Écrire un bloc d'octets dans un fichier externe Masquer les détails

<Résultat> = <Fichier manipulé>.Ecrit(<Bloc à écrire> [, <Taille à écrire>])
<Résultat> : Entier
  • Nombre d'octets écrits dans le fichier.
  • -1 en cas d'erreur. Pour connaître le libellé de l'erreur, utilisez la fonction ErreurInfo avec la constante errMessage.
<Fichier manipulé> : Variable de type FichierDisque
Nom de la variable de type FichierDisque initialisée avec la fonction <Variable FichierDisque>.Ouvre ou <Variable FichierDisque>.Crée.
<Bloc à écrire> : Chaîne de caractères
Bloc d'octets à écrire dans le fichier (2 Go maximum).
Le format du bloc d'octets est respecté. Aucune conversion n'est effectuée.
<Taille à écrire> : Entier optionnel
Taille en octets de la chaîne à écrire.
Remarques

Gestion des erreurs

La fonction <Variable FichierDisque>.Ecrit génère une erreur dans les cas suivants :
  • le fichier n'est pas ouvert,
  • le fichier n'est pas accessible en écriture,
  • le fichier est bloqué par un autre poste ou par une autre application,
  • il n'y a pas d'espace disponible sur le disque.

Retour chariot à la fin d'une ligne

La fonction <Variable FichierDisque>.EcritLigne permet d'insérer automatiquement un retour chariot (RC) à la fin de la ligne ajoutée. Pour insérer un retour chariot (RC) avec <Variable FichierDisque>.Ecrit, il suffit d'utiliser la constante RC.
Par exemple :
MonFichier est un FichierDisque
...
ResEcriture = MonFichier.Ecrit("Compte-rendu" + RC + "Ventes de mars 2021")

Position dans le fichier

A l'ouverture d'un fichier, la position en cours correspond :
  • au premier octet du fichier (par défaut),
  • au dernier octet du fichier si le fichier est ouvert en "ajout" (constante foAjout).
Cette position peut être modifiée par la fonction <Variable FichierDisque>.Positionne.
La fonction <Variable FichierDisque>.Ecrit écrit les éléments spécifiés à partir de la position en cours. Après l'exécution de <Variable FichierDisque>.Ecrit, la position en cours correspond au dernier octet écrit.
Remarque : Pour lire toujours le début de la zone, il faut donc faire appel à la fonction <Variable FichierDisque>.Positionne puis à la fonction <Variable FichierDisque>.Lit.
Classification Métier / UI : Code métier
Composante : wd290std.dll
Version minimum requise
  • Version 28
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/09/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale